Agilent Technologies N1231A API Readme File
===========================================

=========================
Version 1.1
=========================

Version 1.1 is functionally the same as Version 1.0.  However, it has been re-compiled to operate with a newer driver (Pci9030.sys) and DLL (PlxApi.dll) supplied by PLX Technology, Inc.  

Version 1.1 can be installed for use under:
  Microsoft Windows NT 4.0
  Microsoft Windows 2000
  Microsoft Windows XP
(Version 1.0 was only provided for NT 4.0)

The following file is used during hardware driver installation under Windows XP and Windows 2000:
    N1231.inf       Used during installation under Windows XP or Windows 2000.

IMPORTANT NOTE:
Installation of Version 1.1 will overwrite existing Pci9030.sys and PlxApi.dll files.  Therefore, other programs dependent on these files may no longer operate.  If the installation program detects these older files it will issue a warning.  In this case, consider installing Version 1.0 of this program (only available for Windows NT 4.0).  Version 1.0 is available on this setup CD in the following directories:
  \Version 1_0\N1231A API Development

N1231A Monitor is compatible with either version (1.0 or 1.1) of the N1231A API.

Except as noted, the description of Version 1.0, below, also applies to Version 1.1.

=========================
Version 1.0 
(NOTE: Version 1.0 is available for installation under Windows NT only)
=========================

REBOOTING COMPUTER:

The setup program installs a driver file, Pci9030.sys.  Under Windows NT, if this is the first installation of this software, or if the driver file was removed during a previous uninstall, then it will be necessary to reboot the computer after the installation. 

TYPICAL SETUP:

The "Typical" setup installs the DLL files for accessing the N1231A into the windows system directory.  The PCI driver file for the N1231A is installed into the "Drivers" directory under the windows system directory. 

An example program is installed in the default location of: 
  "C:\Program Files\Agilent\N1231A API\"

Files needed for code development (including copies of the DLL and driver file) are installed in the default location of:
  "C:\Program Files\Agilent\N1231A API\User Files"

FILES INSTALLED IN THE "USER FILES" DIRECTORY:

  Files developed by PLX Technology, Inc.:
    Pci9030.sys      Driver file
    PlxApi.dll       Application interface for Pci9030.sys

  Files developed by Agilent Technologies: 
    Example.cpp      Source code for the Example.exe program
    N1231A.dll       Application interface for N1231A
    N1231A.h         Header file
    N1231A_reg.h     Header file with memory map and bit maps
    N1231A.lib       Import Library for use with N1231A.dll

USE OF ABOVE FILES DURING CODE DEVELOPMENT:

- N1231A.h should be included in the source code (using "#include N1231A.h").  This file (N1231A.h) will also include the file N1231A_reg.h.

- N1231A.lib should be available to the linker.

- N1231A.dll and PlxApi.dll must be available at run time.  They can be in the same directory as the executable, in the windows directory, in the windows system directory, or in the "path."  Note that the setup program for "N1231A API" places copies of these files in the windows system directory.

- Pci9030.sys is a driver file which must be available at run time.  It is installed in the "Drivers" directory under the windows system directory.  Under Windows NT, after this file is installed for the first time the system must be rebooted (with the N1231A card inserted) so windows can recognize this file as a driver.

- Example.cpp is a source code file that can be used as a sample of how the N1231A API functions are used.

